home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / cmds.fmt / sendmail.man < prev    next >
Encoding:
Text File  |  1989-01-16  |  12.5 KB  |  331 lines
  1.  
  2.  
  3.  
  4. SENDMAIL                  User Commands                  SENDMAIL
  5.  
  6.  
  7.  
  8. NNAAMMEE
  9.      sendmail - send mail over the internet
  10.  
  11. SSYYNNOOPPSSIISS
  12.      sseennddmmaaiill [ flags ] [ address ...  ]
  13.  
  14.      nneewwaalliiaasseess
  15.  
  16.      mmaaiillqq [ --vv ]
  17.  
  18. DDEESSCCRRIIPPTTIIOONN
  19.      _S_e_n_d_m_a_i_l sends a message to one or more _r_e_c_i_p_i_e_n_t_s, routing
  20.      the message over whatever networks are necessary.  _S_e_n_d_m_a_i_l
  21.      does internetwork forwarding as necessary to deliver the
  22.      message to the correct place.
  23.  
  24.      _S_e_n_d_m_a_i_l is not intended as a user interface routine; other
  25.      programs provide user-friendly front ends; _s_e_n_d_m_a_i_l is used
  26.      only to deliver pre-formatted messages.
  27.  
  28.      With no flags, _s_e_n_d_m_a_i_l reads its standard input up to an
  29.      end-of-file or a line consisting only of a single dot and
  30.      sends a copy of the message found there to all of the
  31.      addresses listed.  It determines the network(s) to use based
  32.      on the syntax and contents of the addresses.
  33.  
  34.      Local addresses are looked up in a file and aliased
  35.      appropriately.  Aliasing can be prevented by preceding the
  36.      address with a backslash.  Normally the sender is not
  37.      included in any alias expansions, e.g., if `john' sends to
  38.      `group', and `group' includes `john' in the expansion, then
  39.      the letter will not be delivered to `john'.
  40.  
  41.      Flags are:
  42.  
  43.      --bbaa         Go into ARPANET mode.  All input lines must end
  44.                  with a CR-LF, and all messages will be generated
  45.                  with a CR-LF at the end.  Also, the ``From:''
  46.                  and ``Sender:'' fields are examined for the name
  47.                  of the sender.
  48.  
  49.      --bbdd         Run as a daemon.  This requires Berkeley IPC.
  50.                  _S_e_n_d_m_a_i_l will fork and run in background listen-
  51.                  ing on socket 25 for incoming SMTP connections.
  52.                  This is normally run from /_e_t_c/_r_c.
  53.  
  54.      --bbii         Initialize the alias database.
  55.  
  56.      --bbmm         Deliver mail in the usual way (default).
  57.  
  58.      --bbpp         Print a listing of the queue.
  59.  
  60.  
  61.  
  62.  
  63. Sprite v1.0               May 22, 1986                          1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. SENDMAIL                  User Commands                  SENDMAIL
  71.  
  72.  
  73.  
  74.      --bbss         Use the SMTP protocol as described in RFC821 on
  75.                  standard input and output.  This flag implies
  76.                  all the operations of the --bbaa flag that are com-
  77.                  patible with SMTP.
  78.  
  79.      --bbtt         Run in address test mode.  This mode reads
  80.                  addresses and shows the steps in parsing; it is
  81.                  used for debugging configuration tables.
  82.  
  83.      --bbvv         Verify names only - do not try to collect or
  84.                  deliver a message.  Verify mode is normally used
  85.                  for validating users or mailing lists.
  86.  
  87.      --bbzz         Create the configuration freeze file.
  88.  
  89.      --CC_f_i_l_e      Use alternate configuration file.  _S_e_n_d_m_a_i_l
  90.                  refuses to run as root if an alternate confi-
  91.                  guration file is specified.  The frozen confi-
  92.                  guration file is bypassed.
  93.  
  94.      --dd_X         Set debugging value to _X.
  95.  
  96.      --FF_f_u_l_l_n_a_m_e  Set the full name of the sender.
  97.  
  98.      --ff_n_a_m_e      Sets the name of the ``from'' person (i.e., the
  99.                  sender of the mail).  --ff can only be used by
  100.                  ``trusted'' users (normally _r_o_o_t, _d_a_e_m_o_n, and
  101.                  _n_e_t_w_o_r_k) or if the person you are trying to
  102.                  become is the same as the person you are.
  103.  
  104.      --hh_N         Set the hop count to _N. The hop count is incre-
  105.                  mented every time the mail is processed.  When
  106.                  it reaches a limit, the mail is returned with an
  107.                  error message, the victim of an aliasing loop.
  108.                  If not specified, ``Received:'' lines in the
  109.                  message are counted.
  110.  
  111.      --nn          Don't do aliasing.
  112.  
  113.      --oo_x_v_a_l_u_e    Set option _x to the specified _v_a_l_u_e. Options are
  114.                  described below.
  115.  
  116.      --qq[[_t_i_m_e]]    Processed saved messages in the queue at given
  117.                  intervals.  If _t_i_m_e is omitted, process the
  118.                  queue once.  _T_i_m_e is given as a tagged number,
  119.                  with `s' being seconds, `m' being minutes, `h'
  120.                  being hours, `d' being days, and `w' being
  121.                  weeks.  For example, ``-q1h30m'' or ``-q90m''
  122.                  would both set the timeout to one hour thirty
  123.                  minutes.  If _t_i_m_e is specified, _s_e_n_d_m_a_i_l will
  124.                  run in background.  This option can be used
  125.                  safely with --bbdd.
  126.  
  127.  
  128.  
  129. Sprite v1.0               May 22, 1986                          2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. SENDMAIL                  User Commands                  SENDMAIL
  137.  
  138.  
  139.  
  140.      --rr_n_a_m_e      An alternate and obsolete form of the --ff flag.
  141.  
  142.      --tt          Read message for recipients.  To:, Cc:, and Bcc:
  143.                  lines will be scanned for recipient addresses.
  144.                  The Bcc: line will be deleted before transmis-
  145.                  sion.  Any addresses in the argument list will
  146.                  be suppressed, that is, they will _n_o_t receive
  147.                  copies even if listed in the message header.
  148.  
  149.      --vv          Go into verbose mode.  Alias expansions will be
  150.                  announced, etc.
  151.  
  152.      There are also a number of processing options that may be
  153.      set.  Normally these will only be used by a system adminis-
  154.      trator.  Options may be set either on the command line using
  155.      the --oo flag or in the configuration file.  These are
  156.      described in detail in the _S_e_n_d_m_a_i_l _I_n_s_t_a_l_l_a_t_i_o_n _a_n_d _O_p_e_r_a_-
  157.      _t_i_o_n _G_u_i_d_e.  The options are:
  158.  
  159.      A_f_i_l_e       Use alternate alias file.
  160.  
  161.      c           On mailers that are considered ``expensive'' to
  162.                  connect to, don't initiate immediate connection.
  163.                  This requires queueing.
  164.  
  165.      d_x          Set the delivery mode to _x. Delivery modes are
  166.                  `i' for interactive (synchronous) delivery, `b'
  167.                  for background (asynchronous) delivery, and `q'
  168.                  for queue only - i.e., actual delivery is done
  169.                  the next time the queue is run.
  170.  
  171.      D           Try to automatically rebuild the alias database
  172.                  if necessary.
  173.  
  174.      e_x          Set error processing to mode _x. Valid modes are
  175.                  `m' to mail back the error message, `w' to
  176.                  ``write'' back the error message (or mail it
  177.                  back if the sender is not logged in), `p' to
  178.                  print the errors on the terminal (default), `q'
  179.                  to throw away error messages (only exit status
  180.                  is returned), and `e' to do special processing
  181.                  for the BerkNet.  If the text of the message is
  182.                  not mailed back by modes `m' or `w' and if the
  183.                  sender is local to this machine, a copy of the
  184.                  message is appended to the file ``dead.letter''
  185.                  in the sender's home directory.
  186.  
  187.      F_m_o_d_e       The mode to use when creating temporary files.
  188.  
  189.      f           Save UNIX-style From lines at the front of mes-
  190.                  sages.
  191.  
  192.  
  193.  
  194.  
  195. Sprite v1.0               May 22, 1986                          3
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. SENDMAIL                  User Commands                  SENDMAIL
  203.  
  204.  
  205.  
  206.      g_N          The default group id to use when calling
  207.                  mailers.
  208.  
  209.      H_f_i_l_e       The SMTP help file.
  210.  
  211.      i           Do not take dots on a line by themselves as a
  212.                  message terminator.
  213.  
  214.      L_n          The log level.
  215.  
  216.      m           Send to ``me'' (the sender) also if I am in an
  217.                  alias expansion.
  218.  
  219.      o           If set, this message may have old style headers.
  220.                  If not set, this message is guaranteed to have
  221.                  new style headers (i.e., commas instead of
  222.                  spaces between addresses).  If set, an adaptive
  223.                  algorithm is used that will correctly determine
  224.                  the header format in most cases.
  225.  
  226.      Q_q_u_e_u_e_d_i_r   Select the directory in which to queue messages.
  227.  
  228.      r_t_i_m_e_o_u_t    The timeout on reads; if none is set, _s_e_n_d_m_a_i_l
  229.                  will wait forever for a mailer.  This option
  230.                  violates the word (if not the intent) of the
  231.                  SMTP specification, show the timeout should
  232.                  probably be fairly large.
  233.  
  234.      S_f_i_l_e       Save statistics in the named file.
  235.  
  236.      s           Always instantiate the queue file, even under
  237.                  circumstances where it is not strictly neces-
  238.                  sary.  This provides safety against system
  239.                  crashes during delivery.
  240.  
  241.      T_t_i_m_e       Set the timeout on undelivered messages in the
  242.                  queue to the specified time.  After delivery has
  243.                  failed (e.g., because of a host being down) for
  244.                  this amount of time, failed messages will be
  245.                  returned to the sender.  The default is three
  246.                  days.
  247.  
  248.      t_s_t_z,_d_t_z    Set the name of the time zone.
  249.  
  250.      u_N          Set the default user id for mailers.
  251.  
  252.      In aliases, the first character of a name may be a vertical
  253.      bar to cause interpretation of the rest of the name as a
  254.      command to pipe the mail to.  It may be necessary to quote
  255.      the name to keep _s_e_n_d_m_a_i_l from suppressing the blanks from
  256.      between arguments.  For example, a common alias is:
  257.  
  258.  
  259.  
  260.  
  261. Sprite v1.0               May 22, 1986                          4
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. SENDMAIL                  User Commands                  SENDMAIL
  269.  
  270.  
  271.  
  272.           msgs: "|/usr/ucb/msgs -s"
  273.  
  274.      Aliases may also have the syntax ``:include:_f_i_l_e_n_a_m_e'' to
  275.      ask _s_e_n_d_m_a_i_l to read the named file for a list of reci-
  276.      pients.  For example, an alias such as:
  277.  
  278.           poets: ":include:/usr/local/lib/poets.list"
  279.  
  280.      would read /_u_s_r/_l_o_c_a_l/_l_i_b/_p_o_e_t_s._l_i_s_t for the list of
  281.      addresses making up the group.
  282.  
  283.      _S_e_n_d_m_a_i_l returns an exit status describing what it did.  The
  284.      codes are defined in <_s_y_s_e_x_i_t_s._h>
  285.         EX_OK            Successful completion on all addresses.
  286.         EX_NOUSER        User name not recognized.
  287.         EX_UNAVAILABLE   Catchall meaning necessary resources
  288.                          were not available.
  289.         EX_SYNTAX        Syntax error in address.
  290.         EX_SOFTWARE      Internal software error, including bad
  291.                          arguments.
  292.         EX_OSERR         Temporary operating system error, such
  293.                          as "cannot fork".
  294.         EX_NOHOST        Host name not recognized.
  295.         EX_TEMPFAIL      Message could not be sent immediately,
  296.                          but was queued.
  297.  
  298.      If invoked as _n_e_w_a_l_i_a_s_e_s, _s_e_n_d_m_a_i_l will rebuild the alias
  299.      database.  If invoked as _m_a_i_l_q, _s_e_n_d_m_a_i_l will print the con-
  300.      tents of the mail queue.
  301.  
  302. FFIILLEESS
  303.      Except for /usr/lib/sendmail.cf, these pathnames are all
  304.      specified in /usr/lib/sendmail.cf.  Thus, these values are
  305.      only approximations.
  306.  
  307.      /usr/lib/aliases              raw data for alias names
  308.      /usr/lib/aliases.pag
  309.      /usr/lib/aliases.dir          data base of alias names
  310.      /usr/lib/sendmail.cf          configuration file
  311.      /usr/lib/sendmail.fc          frozen configuration
  312.      /usr/lib/sendmail.hf          help file
  313.      /usr/lib/sendmail.st          collected statistics
  314.      /usr/spool/mqueue/*           temp files
  315.  
  316. SSEEEE AALLSSOO
  317.      binmail(1), mail(1), rmail(1), syslog(3), aliases(5),
  318.      sendmail.cf(5), mailaddr(7), rc(8);
  319.      DARPA Internet Request For Comments RFC819, RFC821, RFC822;
  320.      _S_e_n_d_m_a_i_l - _A_n _I_n_t_e_r_n_e_t_w_o_r_k _M_a_i_l _R_o_u_t_e_r (SMM:16);
  321.      _S_e_n_d_m_a_i_l _I_n_s_t_a_l_l_a_t_i_o_n _a_n_d _O_p_e_r_a_t_i_o_n _G_u_i_d_e (SMM:7)
  322.  
  323.  
  324.  
  325.  
  326.  
  327. Sprite v1.0               May 22, 1986                          5
  328.  
  329.  
  330.  
  331.